// Copyright (C) 2002-2008 Nikolaus Gebhardt
// This file is part of the "Irrlicht Engine".
// For conditions of distribution and use, see copyright notice in irrlicht.h

#ifndef __I_WRITE_FILE_H_INCLUDED__
#define __I_WRITE_FILE_H_INCLUDED__

#include "IReferenceCounted.h"


	//! Interface providing write acess to a file.
	class IWriteFile : public virtual IReferenceCounted
	{
	public:
		inline s32 WriteS8( s8 val )   { return write( &val, 1 ); }
		inline s32 WriteS16( s16 val ) { return write( &val, 2 ); }
		inline s32 WriteS32( s32 val ) { return write( &val, 4 ); }

		inline s32 WriteU8( u8 val ) { return write( &val, 1 ); }
		inline s32 WriteU16( u16 val ) { return write( &val, 2 ); }
		inline s32 WriteU32( u32 val ) { return write( &val, 4 ); }

		inline s32 WriteF32( f32 val ) { return write( &val, 4 ); }

		//! Writes an amount of bytes to the file.
		/** \param buffer Pointer to buffer of bytes to write.
		\param sizeToWrite Amount of bytes to write to the file.
		\return How much bytes were written. */
		virtual s32 write(const void* buffer, u32 sizeToWrite) = 0;

		//! Changes position in file
		/** \param finalPos Destination position in the file.
		\param relativeMovement If set to true, the position in the file is
		changed relative to current position. Otherwise the position is changed
		from begin of file.
		\return True if successful, otherwise false. */
		virtual bool seek(long finalPos, bool relativeMovement = false) = 0;

		//! Get the current position in the file.
		/** \return Current position in the file in bytes. */
		virtual long getPos() const = 0;

		//! Get name of file.
		/** \return File name as zero terminated character string. */
		virtual const c8* getFileName() const = 0;
	};

	//! Internal function, please do not use.
	IWriteFile* createWriteFile(const c8* fileName, bool append);

#endif

